Skip to content

Add custom connectors page under Configurable connectors - #621

Open
gontzess wants to merge 3 commits into
mainfrom
gontzess/custom-connectors-docs
Open

gontzess wants to merge 3 commits into
mainfrom
gontzess/custom-connectors-docs

Conversation

@gontzess

Copy link
Copy Markdown
Contributor

Why

In-app authored connectors (shown in the product as Custom connectors, built with the C1AI assistant) are close to early-access availability and there is no customer-facing documentation for them. Customers need to know when this option fits versus a pre-built connector or self-authored HTTP/SQL/SCIM configuration, what the build and approval flow looks like, and what to expect from the test and review step.

What this changes

  • New page developer/custom-connectors.mdx, first in the Configurable connectors group. It covers when to use a custom connector, prerequisites, the build steps, a short explanation of hosting, testing and independent review, management after launch, and limits and FAQs. It stays at the product level and does not describe internal machinery.
  • Adds the page to docs.json.
  • Renames the SDK comparison heading on the HTTP authoring page from "custom connector" to "connector built with the Baton SDK", since "custom connector" is now the product name for the assistant-built kind.

Please check before publishing

  • Availability note. The page says early access and to ask the account team. Adjust if the rollout plan differs.
  • Provisioning. The page says custom connectors do not support provisioning today. Correct this if write actions are supported at launch.
  • Removing an active connector. The page points to disabling it under Connectors. Confirm that is the intended guidance.
  • No screenshots yet. The sibling pages in this group have none either.

Customer-facing overview of building a connector with the C1AI
assistant: when to choose it over pre-built or self-authored
connectors, the build and approval flow, how testing and independent
review work, management after launch, and limits and FAQs. Adds the
page to the Configurable connectors nav group and renames the HTTP
authoring page's SDK comparison so "custom connector" is not used
for two different things.
@mintlify

mintlify Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
conductorone 🟢 Ready View Preview Oct 30, 2026, 12:35 AM

@gontzess
gontzess marked this pull request as ready for review October 29, 2026 18:25

This branch was successfully deployed

1 active deployment
staging — 4e2be30d Deployed Oct 30, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant